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1. Overview 



LAT Host Services Components 

Local Area Transport (LAT) is a network protocol developed primarily by 
Digital Equipment Corporation. The diagram below details the LAT protocol 
layer and ISO Open System Interconnect model. 



Data* 



Physical 



Ethernet 

Token 

FDDI 



LAT 



Transport 



Network 



Data 



Physical 



ISO 



The LAT protocol provides transport layers which enable remote login to 
the host from another LAT terminal device and print services from the host to 
a remote LAT printer. Current implementations run using an Ethernet data/ 
physical link, but could easily run on an equally fast medium such as a 4-16 
megabit token ring or a 100 megabit Fiber Distributed Data Interface (FDDI). 
The network layer, or virtual circuit layer, establishes and maintains a virtual 
circuit between a services node and a server. 

The transport layer, or slot layer, establishes service sessions and the 
exchange of data by multiplexing and demultiplexing data transferred 
between a server port and service session on the service or host node. 

The LAT Host Services components (lat and latcp) and your system use 
the LAT protocol to provide: 

1 ) Login access to your system from terminals connected to terminal servers 
or workstations/PCs appearing as terminals connected to a terminal 
server. 

2) System access to printer(s) connected to a terminal server. 

3) Ability to gather LAT network statistics. 

4) Tools to clearly define problems if and when they arise. 
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lat 



An event driven protocol engine and the following three interfaces comprise 
the lat component: datalink interface, command/management interface, and 
multiple user services interfaces. 

The heart of the lat component is the event driven protocol engine. It has 
two states, idle (wait) state and process event state. In the idle state, the 
protocol engine waits until an event is present. As events are queued by each 
of the three interfaces into their respective event queues, the protocol engine 
processes them. 

The protocol engine removes a single event from the datalink interface's 
event queue first, the command/management interface's event queue second 
and each of the multiple user_service interface ' s event queues third. It repeats 
the process until no queue contains any events. It then enters the idle state. 
Each event is processed to completion at each queue before proceeding to the 
next queue in the above specified order. 

The following pseudo code serves to further clarify the event processing 
logic. 

dowhile (event present) 

if (datalink interface's event present) then 
process (next datalink interface event) 
endif 
if (command/management interface event present) then 

process (next command/management interface event) 
endif 
for (each of the user__service interface's queues) 

if (user_service interface's event present for 
port [number] present) then 
process (next user__service interface event) 
endif 
endfor 
enddowhile 

Table 1-1 lists typical events associated with each interface and the action 
taken as a result of the event. 



c 
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Interface 
datalink 



Table 1-1. Interface event table 

Event Action Taken 



management/ 
command 



management/ 
command 



management/ 
command 

management/ 
command 



Receipt of 6004 
protocol type 
network packet 



Request to display 
lat statistics. 



Ask server to make 
a connection from 
the specified port. 

Start protocol trace. 



Stop protocol trace. 



Process lat messages including 
starting and maintaining lat 
demultiplexing data in lat slots 
coming from a terminal server 
port. 

Reads lat counters in virtual cir- 
cuit slot and executor databases 
and displays. 

Builds host initiated message and 
sends it to server. 



Writes all packets to user speci- 
fied disk file for later analysis. 

Closes disk file containing lat 
protocol messages in binary 
format. 



management/ 
command 



management/ 
command 



user_services 
interface 



Stop lat program. 



Request to turn on 
debugging. 



Complete rundown of lat program 
includes display of final network 
statistics. 

Depending on the level of debug 
specified, the lat process will 
display lat events and messages. 



Characters/data Places characters/data in slot 

from print spoolers messages and transmits to 

or terminal input/output, terminal server. 



The datalink interface forwards received network packets with protocol 
type 6004 to the lat protocol engine. It serves as an interface for transmitting 
lat protocol messages. 

The command and management interface provides input from user 
commands entered via a lat command line or latcp command line interface. 

The user service interface provides data from user services such as user 
process via /bin/login. 
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latcp 



This is a program which communicates management and command requests 
to a lat component protocol engine, latcp places requests into the command 
management event queue. These requests include the following: 

1) Zero slot, circuit counters 

2) Show executor, circuit, and slot counters 

3) Stop lat or latcp 

4) Establish an application port for use as a local system printer port 

5) Set delay mode for display of internal info 

6) Turn protocol tracing on and off 



c 



latcp 



Show 
Counters 



Zero 
Counters 



Start/Stop 
Protocol Trace 



Stop or 
Halt 



Establish 
Application/ 
Printer Port 



Set Debug 



lat 



datalink 



c 



The command syntax and returned value are detailed in chapter 5, "LAT 
Statistics." Set debug and protocol trace are detailed in chapter 6, 
"Troubleshooting LAT." 

Iat 9 latcp and Your System's Relationship 

lat and latcp are executable programs which run in user process space and 
communicate with the Ethernet. 

lat is forked as a background task when started. It may be started with a - 
nofork option and run in the foreground. 



USER PID 


SZ 


RSS 


TTY STAT 


TIME 


COMMAND 


corrigan 651 


96 


48 


padOO S 


0:00 


sulO 


root 652 


160 


122 


padOO S 


0:01 


sh 


root 654 


160 


133 


padOO S 


0:00 


lat -nofork 



In the above example, lat is running in user space with a LAT command 
line interface. 

From the LAT interface, or from latcp if the lat is forked, you can gather 
statistics, set up printer ports, and do troubleshooting. 
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Command/Management 
Requests 



lat Responses 



lat responds by displaying the requested statistics, attempting to establish 
a printer port, and tracing the lat protocol stack or displaying debug info. 

Pseudo terminals are software terminals. There is no corresponding 
hardware associated with a pseudo terminal. Print spoolers generate output to 
devices. These devices may be pseudo devices such as pseudo terminals. LAT 
uses pseudo terminals for logging in remote users and for connecting remote 
devices. With a print spooler output directed to a pseudo terminal that LAT 
has connected to a remote device, the printing is done on this remote device. 

In addition to the pseudo terminal and printer port interfaces, there is the 
datalink interface. The current datalink interface is an Ethernet interface. 
Packets with protocol type 6004 are received from the network for 
processing. Packets bound for terminal server ports, and miscellaneous 
keepalive and service messages, are transmitted over the datalink interface. 



Read/Write/Set Protocol Type/Get Addr 



Ethernet Driver 



Process/User 
Space 



Kernel Space 



System 

The datalink code is in the kernel with a user interface. These Ethernet 
routines are not generally available to the user but are available to the lat 
program. 
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2. Starting lat 



This chapter explains how lat is automatically started and how to start lat 
from the command line. 

Automatic lat Startup 

When the system is powered up in multi-user mode, the file /etc/init.d/lat is 
executed with start as a parameter. This script starts lat and runs it as a 
daemon. 

Starting lat from the Command Line 

Forked 

You can simply enter the lat command, and lat will be forked, displaying 
output similar to the following: 

Ki2: lat 

Ki Research, Inc: LAT Version 4.2.5 

Forking Network Daemon. 

This command is usually placed in the startup command file. 



Not Forked 



You can also create a command line interface to lat by specifying the 
-nofork option. The following output will be displayed if you enter the 
lat -nofork command: 

Ki2: lat -nofork 

Ki Research, Inc: LAT Version 4.2.5 

LAT Rating File: ' /usr/etc/rating.lat f 

Default Ethernet name is laO 
Max Session Allowed: 16 



The lat Options 



Table 2-1 lists each lat option by name, describes it and gives an instance of 
when you may want to use it. 
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Option 
-banners 



-[no]fork 
-groups=# 

-ld= 
-lan= 

-ratlng=# 
-services 

-servicejd= 

-sessions=# 
-[no]uppercase 



Table 2-1. lat options 

Description 

This text is displayed when a user connects to lat. The 
default is Welcome to Ki Research, Inc. LAT Host 
Services. Use if you want to specify a banner. 

Run lat as a background daemon. (Default: fork) If 
you want to run lat in foreground: -not ork. If you want 
to run lat in background: -fork. 

Set the lat Groups to which this node belongs. The 
default is Group 0. Valid groups are to 255. A range 
of groups may be specified as #-#; i.e., 0-5. Use if you 
want more than/other than Group 0. 

The local node identification. By default this is set to 
Ki LAT Host Services. Use if you want to specify an ID. 

The LAN identifier, such a leO, enO, or 0, for non- 
UNIX systems. Use if you have an alternate LAN 
device. 

The rating to assign the local node. By default this 
value is 6. Use if you want a value other than 6. 

The service name to declare. The default is the local 
hostname. Any number of service names may be 
declared. Use if you want to specify a service. 

The service identification. The default value is 
Interactive Login. Each ID matches any specified 
services in the order in which they are specified. Use if 
you want to specify a service ID. 

Allowed number of sessions. The maximum is 1024. 
Use if you want to restrict access. 

Use lower case node and service names (default: 
uppercase). If you have terminal servers that can 
handle lower case names use -uppercase. If you have 
terminal servers than can't handle lower case names 
use -nouppercase. 



c 



c 



c 



2-2 



LAT Host Services User's Manual [2.0] 



Logging in from Your Terminal 



3. Logging In from Your Terminal Server 



The total number of LAT terminal server ports has reached roughly two 
million (2,000,000) Ethernet terminal ports. This is a sizeable number, 
repeating a well-established and useful terminal access method. 

To access your system from a terminal server, use the connect 
<nodename> command, where nodename is usually the system's 
hostname. A different node name may have been specified when starting lat 
For example, 

> connect ims 

You can show the available services/nodes/hosts that you can connect to 
by entering the show services or show node commands. For example, 

> show nodes 

Summary Display 
NODE NAME STATUS IDENTIFICATION 

(name of node) REACHABLE (word or phrase) 
UNREACHABLE 
UNKNOWN 
{n}CONNECTED 



> show services 

Service Summary Display 
NODE NAME STATUS IDENTIFICATION 

(name of service) REACHABLE (word or phrase) 

UNREACHABLE 

UNKNOWN 

{n} CONNECTED 



LAT Host Services Users Manual [2.0] 3 - 1 



c 



( 



c 



Setting Up Print Services 



4. Setting Up Print Services 

This chapter contains the information necessary to set up a printer port on the 
terminal server for your host's use. It gives suggested modifications to your 
printcap. 

Establishing a Printer Port 

In order to establish a printer port on the terminal server, you must know the 
server's name and the server's port_name. In order to determine the terminal 
server's name, enter the show server command on a lat terminal attached to 
the terminal server. For example, 

>show server 

Server Characteristics Display 

VISTA 1.0 VERSION: UPTIME: 

ADDRESS: NAME: NUMBER: 

CIRCUIT TIMER: PASSWORD LIMIT: 

CONSOLE PORT: QUEUE LIMIT: 

INACTIVITY TIMER: RETRANSMIT LIMIT: 

KEEPALIVE TIMER: SESSION LIMIT: 

MULTICAST TIMER: SOFTWARE: 
NODE LIMIT: 
MAXIMUM CIRCUITS: 
MAXIMUM SERVICES 

SERVICE GROUPS: 

ENABLED CHARACTERISTICS: 

To determine the port's name, enter the show port command. For exam- 
ple, 

>show port 

Show Port Status Display 

PORT {number}: {port user name} 

ACCESS: CURRENT SERVICE: 

STATUS: CURRENT MODE: 

SESSIONS: CURRENT PORT: 

INPUT XOFFed: OUTPUT SIGNALS: 

OUTPUT XOFFed: INPUT SIGNALS: 

The default port name is port_n, where n is the port number. 
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Once the port number and server name have been determined, you need 
only decide on a /dev/filename that you wish to use for identifying the 
/dev/ pseudo terminal returned by the create port command. In the follow- 
ing example, we are creating a printer port to which your print spooler can 
write. 

create port D200 P0RT__1 as latprint 

Port created on '/dev/ttyp2' as ' /dev/ latprint f 

You may direct printer output to the latprint device. You can also use the 
/dev/ttyp2 device as well in your print command, although this is not 
recommended. 



c 



lat and Print Spoolers 



The print spooler on your system may now direct output to the latprint device 
or ttyp device, as if the printer were directly connected to your system with 
an async wire. 

Hardwired Printer 



your platform 



async wire 



lat Equivalent 



printer 



c 



your platform 



Ethernet 



other platform 



other platform 



server 








as 


sync wire 




printer 



LAT Host Services allow the printer attached to the terminal server to be 
used as needed by the print spooler on your system lat makes the connection 
to the terminal server port and passes the print spooler output directly to it. 



c 
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In the event that the printer is busy, the terminal server will queue your 
lat's request until the printer is available. As the printer is made available, the 
print spooler output will complete. If the terminal server goes off line, an error 
will be returned. 

When lat is running in the foreground, and the printer is outputting, the 
following error appears: 

Virtual Circuit Timeout 

Remote server address: AA-BB-CC-DD-EE-FF 

If the printer is not printing, no error is generated. 

When the printer is down while trying to connect, the following error ap- 
pears: 

Unable to connect application port, no response from server 

Dead ports device: xxx 

Will try connecting again in 15 minutes 

Creating the Printer Port at lat Initialization 

When lat starts, it looks for the file /usr/etc/.latrc. If this file is present, it 
executes the commands in the same way as if latcp were running. To create 
a printer port when lat is first started, enter the create port command. For 
example, 

create port 580R43 PORT? as neon 

printcap File 

The file /etc/prlntcap is used to define parameters attached to your system. 
There must be an entry in this file for each printer port you have defined. For 
example, 

Iplneon: \ 

: lp=/dev/neon : sd~/usr/spool : If =/usr/adm/lpd-errs : \ 
fs#023:pl#64:pw#80: 

See the printcap manpage for more details. 
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5. lat Statistics 



The proper syntax for gathering statistics is listed in table 5-1. These 
commands may be entered from the lat command line, LAT>, or the latcp 
prompt (latcp interface to the forked lat process). 

Table 5-1. lat statistics gathering commands 

Description 

Show Executor Database and related 
counter values 

Show Circuit Counter values 

Show Line Counter values 

Show Known Application (printer ports) 

Show Slot Counter values 

Zero the Executor Counter values 

Zero Circuit Counter values 

Zero Line Counter values 

Zero Slot Counter values 



Command 
Show Executor 

Show Known Circuit Counters 
Show Known Line Counters 
Show Known Ports 
Show Known Slot Counters 
Zero Executor Counters 
Zero Known Circuit Counters 
Zero Known Line Counters 
Zero Known Slot Counters 



An example of each statistic gathering command and its related output are 
shown. The minimum number of characters is shown in the example. 



Show Known Circuit Counters 



LATCP> 8 k c C 
Server Name: 
Server 
Zeroed on: 
Time since zeroed: 
Local Circuit ID: 
Remote Circuit ID: 
Number of Slots: 



xxx 

AA-BB-CC-DD-EE-FF 

Fri Nov 17 15:45:20 1989 

10 minutes 25 seconds 

256 (0x0100) 

257 (0x0101) 
7 



Transmitted 



Received 



Messages : 


70 


10 


Bytes : 


1200 


128 


Retransmit Messages : 


10 
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Max Datalink Size: 1500 Bytes 

Keep Alive Timer: 15 seconds 

Next Message #: 72 

Last Received Message #: 10 

Received Ack #: 70 

Data Ready: True 



C 



Total of 1 circuit 

Show Known Line Counters 



LATCP> Ski 

Line Counters for LAN Unit #0 

Zeroed on Fri Nov 3 00:09:09 1989 

Time since zeroed: 20 minutes 59 seconds 







Transmitted 


Received 


Messages : 








Bytes 










Multicast Messages: 




21 





Multicast Bytes: 




2310 





No System Buffer: 









Send Failure: 










c 



Show Known Ports 



LAT> s k p 

Server Ethernet Address: 



00-00-00-00-00-00 



Port 


ID 


0xl000F27C 




Host 


ID 


0x0000 




Server 


ID 


0x0000 




Device 




' /dev/ttyq5' 


as '/dev/latl' 


State 




Wait_JEO 




status 




0x0000 




slotdb 




OxlOOOF2FO 




pty_fd 




6 




srvr 




'VISTA' 




port 




'PORT_l' 




msg_tmr 




[0] 




retransmits 







Groups : 

1 applica- 








tion 


port 





c 
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Show Known Slot Counters 






LAT> s k s c 






Slot Counters 






Server Name: 


VISTA 




Server Address : 


00-00-B5-00-02-B8 




Slot: 


OxlOO00EC5C 




Local Slot ID 


1 (0x0001) 




Remote Slot ID: 


1 (0x0001) 




Process PID: 


4094 




Device : 


'/dev/ttyq4' 




Internal fd: 


: 5 




Zeroed on: 


Thu Nov 2 09:24:06 1989 




Time since zeroed: 


: 35 seconds 






Transmitted 


Received 


Messages : 


41 


36 


Bytes 


744 


221 


Data_A Messages: 


40 


34 


Data_A Bytes : 


561 


17 


Max Data Size #1: 


255 bytes 




Max Data Size #2: 


255 bytes 




Local Credits to Send: 




Remote Credits Received: 2 




Send Queue Length: 


mbufs 




Data Bytes Pending: bytes 




Output Building Length: bytes 




Output Off: 


False 




Application Port: 


0x00000000 




Total of 1 slot 







Show Executor 



LAT> 3 e 

LAT Executor Database: 



Current Rating: 
Current Time : 
Time Zeroed: 
Time since zeroed: 



Fri Nov 3 00:34:51 1989 
Fri Nov 3 00:09:08 1989 
1543 seconds (25 minutes 43 seconds) 
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Counters 




messages 




Bad Node 




Bad Response 




messages 




Bad Status 




messages 




Timers 




80 ms 




Circuit 




Hello 




60 seconds ( 1 minute ) 




Request 




10 seconds 




Wait 




65 seconds ( 1 minute 5 


seconds ) 


Configured Limits 


1500 bytes 




Frame Size 




Slot Size 


255 


• bytes 




Max Sessions 


16 






Max Active Sessions 









Active Sessions 









Retransmit Limit 


9 






Low Water Mark 


342 


bytes (3 buffers @ 114 


bytes each) 


High Water Mark 


798 


bytes (7 buffers @ 114 


bytes each) 


Groups : 


















c 
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Table 5-2. lat statistics table 



Command 

Show Known Line Counters 



Counter Name and Description 

Messages: Total # of LAT messages. 
Bytes: Total # of bytes in the LAT 
messages. 

Multicast Messages: Of the messages, 
those that were multicast. 
Multicast Bytes: Of the bytes, those that 
were multicast. 

No System Buffer: # of times that a mes- 
sage was received and there was no buffer 
to receive it in. 

Send Failure: # of times that a transmit 
failed. 



( 
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Table 5-2. lat statistics table (con't.) 

Command Counter Name and Description 

Show Known Circuit Counters Server Name: The name of the server 

which is connected to this circuit. 
Server Address: Ethernet address of 
Server. 

Zeroed on: Date/time that counters were 
zeroed. 

Time since zeroed: How long since the 
counters were zeroed. 
Local Circuit ID: Unique identifier for 
circuit, assigned by local node. 
Remote Circuit ED: Unique identifier for 
circuit, assigned by remote node. 
Number of slots: # of slots using this 
circuit. 

Messages: # of circuit messages. 
Bytes: # of circuit message bytes. 
Retransmit Msgs: # of circuit messages 
retransmitted. 

Max Datalink Size: # of largest transmit 
size allowed. 

Keep Alive Timer: 3 * server keep-alive- 
timer (to know when server dies). 
Next Msg #: Next circuit message number 
to transmit [0..255] 

Last Rcvd Msg #: LAT circuit message 
number received from remote [0..255] 
Rcv'd ACK #: Last ACK received 
Data Ready: true: data is waiting to be sent 
to server, false: no data waiting for server. 
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Table 5-2. lat statistics table (con't.) 



Command 

Show Known Slot Counters 



Counter Name and Description 

Server Name: The name of the server 

which is connected to this circuit. 

Server Address: Ethernet address of 

server. 

Slot: Internal use [address of slot db]. 

Local Slot ID: Slot identifier assigned by 

local node. 

Remote Slot ID: Slot identifier assigned 

by remote node. 

Process ID: Process ID of child login shell 

(not always accurate). 

Device: Login/application port device 

Internal fd: Internal use (file descriptor 

for the pty). 

Zeroed on: Date/Time that counters were 

zeroed. 

Time since zeroed: How long since the 

counters were zeroed. 

Messages: # slot messages. 

Bytes: # slot bytes. 

Data_A Msgs: # slot messages which were 

Data A slots. 

Data_B Msgs: # slot messages which were 

Data B slots. 

Max Data Size #1: Internal Use. 

Max Data Size #2: Internal Use. 

Local Credits: # of credits to give to 

remote node. 

Remote Credits: # of credits given to us 

from remote node. 

Send Q Length: # of buffers containing 

data waiting to be sent. 

Data Bytes Pending: # of bytes in Send Q. 

Output Bldg Len: # of bytes not yet 

dedicated to Send Q. 

Output Off: true: not accepting new 

output from login/application port. 

Application Port: Internal use (address of 

application port database). 



c 



( 



c 
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Command 

Show Known Ports 



Table 5-2. lat statistics table (con't.) 

Counter Name and Description 

Port ID: Internal use (address of 

application port database). 

Host ID: Unique ID assigned to pending/ 

active port by local node. 

Server ID: Unique ID assigned to pending 

port by remote node. 

Device: Actual and logical device names 

for this port. 

State: State of port: 

Wait__io Waiting for output from 
application before 
connecting. 

Search Searching for remote node. 

Request Requesting connection 
establishment. 

Pend Connection request is 

pending. 

Run Connection is active. 

Unused Port is not in use. 
Status: Last received status from remote 
about pending request. 
slotdb: Internal use [address of slot 
database]. 
pty_fd: Internal use (file descriptor for 

pty). 

srvr: Name of remote node. 

Port: Port name at remote node. 

msg_timr: # of seconds left on timer and 

timer state (state is in []). 

States: - stopped; 1 - active; 2 - expired 

Retransmits: # of times current message 

has been retransmitted. 

Groups: List of groups that this port is a 

member of. 
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Zeroing Counters | 

You may want to zero counters to get a clear picture of how the various 
counters may be growing or not growing in size. The command syntax and 
example commands are: 

Zero Known Line Counters 

LATCP> x klc 

Line counters zeroed 

Zero Known Circuit Counters 

LATCP> 2 k C C 

Circuit Counters Zeroed 

Zero Executor Counters 

LATCP> zee 

Executor Counters Zeroed 

Zero Known Slot Counters 

LATCP> z k s C 

Slot Counters Zeroed 



Syntax 



If you receive the following message try reentering the command or use help | 

to get syntax. V 

LATCP> Sic 

Unknown CONTROL command 

LATCP> sec 

Unknown CONTROL command 

LATCP> 3 pc 

Unknown CONTROL command 



( 
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6. Troubleshooting lat 



This section contains information on two commands which assist in defining 
a lat problem. The commands are scopef lie and set debug. 

You may be asked to enter the scopef He or set debug command for later 
analysis by a support engineer. The explanation of the syntax of each com- 
mand follows. 

scopefile 

The scopefile command allows you to direct lat to write every packet of 
transmit or receive to a specified disk file. To direct packets to 
/bulld/usr/lat/lat_scope.trc you enter: 

LATCP> scopefile /build/us r/ lat /lat_s cope. t re 

SCOPING is ENABLED to ' /build/usr/lat/lat__scope .trc' 

To stop the flow of packets to this file, you enter: 

LATCP> scopefile 

SCOPE file '/build/usr/lat/lat_scope.trc' closed 



set debug 



A support engineer may direct you to set a certain level of debug output. In 
order to do this, you would enter: 

LATCP> set debug 2 
Setting DEBUG to 2. 

The If statements which don't compare with any number, will cause out- 
put to be generated for any level of debug. 

if (KIDEBUG) then printf ("Received CONTROL command '%s'\n n , 

msg) ; 
if (KIDEBUG >«1) then printf ("Killing pid %d, slot is gone\n", 

slotdb->pid) ; 
if (KIDEBUG >=6) then printf ("process_ptv_read: %d bytes\n w , 

by tes) ; 
if (KIDEBUG >«7) then bdump (stdout, bp f bytes); 
if (KIDEBUG >=1) then printf ("process_pty_read: 

Mode=0x%02X\n", control_code) ; 
if (KIDEBUG >«=1) then printf ("pty read returned %d\n", bytes); 
if (KIDEBUG >*7) then printf ("processing from lat_slave 

socket \n") ; 
if (KIDEBUG > 0) then fflush (stdout) ; 
if (KIDEBUG >»=9) then printf ("setting lat_master: 

close (lat master) \n") ; 
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if (KIDEBUG) then printf ("Setting Group %d.\n", j) ; 
if (KIDEBUG >=1) then perror ("findjpty: calling k_getapty") ; 
if (KIDEBUG >=1) then perror ("repoen__pty: finding pty") ; 
if (KIDEBUG >=1) then printf ("process_pty__read: status=0x%- 

8X\n", status. all) ; 
endif 
if (KIDEBUG >=1) then 

{ 

sprintf (errtxt, "-==> errno : %d.\r\n" r errno) ; 

slot__bdata_a_str (slotdb. errtxt) ; 

} 
end_if 
if (KIDEBUG >=1) then 

printf ("process_sock: status=0x%08X\n", status.all); 
end_if 
if (KIDEBUG >=3) then 

printf ("READ Event for ecjium %d, slotdb=0x%X, 

pty_fd=%d\n. ec_num, slotdb, slotdb — >pty_fd; 
end__if 
if (KIDEBUG >=1) then 

{ 

if (not found) then 

printf ("Deaths were registered but none were 
found !\n") ; 

elseif (found not_equals deaths) then 

printf "(Insufficient dead pty f s were found\n") ; 

end_if 

} 
end__if 
if (KIDEBUG >=3) then 

printf ("READ Event for pty__fd= %d\n", slotdb— >pty_fd; 
end_if 
if (KIDEBUG >=1) then 

{ 

printf ("\nPID %d has died\n", pid) ; 
#ifdef BSD 

printf {"\ 

w_Retcode= %d\n\ 

w__Coredumb= %d\n\ 

w^JTermsig* 5 %d\n\ 

", status. w_ret code, status. w__coredumb, 
status. w_termsig) ; 
#endif BSD 

} 
end if 



6-2 LAT Host Services User's Manual [2.0] 



c 



c 



c 



Troubleshooting lat 



if ((not found) && (KIDEBUG >=2) ) then printf ("\ sig_child: 
WARNING, Unable to locate slotdb entry for pid 
%d\n", pid); 
if (KIDEBUG >=1) then 
{ 
printf ("Device '%s' is pty_fd %d\n", slotdb— ->ttyname, 

pty_f d) ; 
} 
end_if 
if (KIDEBUG >=2) then 

printf ("app_port: Device ' %s' is pty__fd=%d\n", slotdb- 
->ttyname f slotdg— >pty_fd) ; 
end if 
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A. Glossary 



advertising. The process that allows users to identify names and 
characteristics of the resources to be used. As applied in this document, the 
term "advertising process" refers to a certain message-exchange mechanism 
provided by the LAT architecture. Each node, whether it is a slave, a master 
or both, can advertise services. 

application terminal. A device that is under control of the application process 
running within a slave environment. In some cases an application device may 
not have a keyboard or even be a "terminal" at all. It may be a line printer, a 
video monitor, a display window etc. 

broadcast As applied to data links, broadcast capability refers to the ability 
of any one port to address all other ports simultaneously with a single 
datagram. 

datagram. An atomic unit of information exchanged by local area networks. 
In the Ethernet implementation, datagrams are required to have a constant 
format consisting of: destination port address, source port address, protocol 
type, data and an error detection code. Datagrams may get corrupted on the 
Ethernet, and are therefore not always delivered to the destination address. 

flow control A set of rules applied to processes which prevents a transmitting 
process from sending data to a receiving process that is not prepared to buffer 
the transmitted data. 

interactive terminal. A device that is under the control of the terminal user 
connected to a node running in master mode. 

local area (network). The topology defined by the set of logically equivalent 
processors directly attached to a shared interconnect. 

master. An addressable process that provides communication attachment 
points for virtual circuits. The master initiates and controls activity over 
virtual circuits. The state-table of a master process is defined in the LAT 
architecture document. 

message. A datagram under virtual circuit error control. 

multicast. As applied to data links, multicast capability refers to the ability of 
any one port to address a subset of all other ports simultaneously with a single 
datagram. 
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name A string of ASCII characters meaningful in the context of the client i 

using it. Names are used to provide identification of entities within the LAT ^- 

architecture that can and need to be identified. Characters within an ASCII 
string representing the name are constrained as described in the section of the 
LAT architecture entitled "Specification of Names." 

node. The environment on the end of the virtual circuit that provides 
functioning of a master and slave process. A node can operate as slave, master 
or both simultaneously. In this document the expression slave (master) node 
really means a node operating in slave (master) mode. Each node is uniquely 
identified by name. 

object A provider of the resources; a passive responder to requests for 
establishing connections. An object does not initiate connections. An object 
can be a master as well as a slave. 

port. An access point that a node presents to users. Each port serves as a 
communication path between a user and a resource. Ports can be named. 

resource. An entity or set of entities known to perform a certain set of 
functions that can be identified, named and accessed within LAT„ 

service. The descriptive name of the resources. The name is used by users to 
identify a resource and is used by LAT to establish an access path to the 
resource. 

service class. A 1-byte value in the range 0-255. 
value - reserved 
value 1 - reserved for interactive and application terminals (serial byte 

stream processing) 
values in the range 2 to 127 reserved for DEC use 
values in the range 128-255 reserved for customers 

session. A transient association that allows a subject to exchange data reliably 
with an object by utilizing an underlying shared virtual circuit 

session (connection). A transient association which allows a terminal server 
to exchange data reliably with a single host service utilizing and underlying 
shared virtual circuit. 

slave. An addressable process that provides the passive side of the 
communication attachment point for a virtual circuit. The slave responds to 
the master's request. The state-table of a slave process is defined in the LAT 
architecture document. 

slot. A segment of a message used to communicate data between a terminal 
on a terminal server and a host service. Messages may have zero or more 
slots. 



( 



( 
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subject A consumer of the resources, an active initiator of a connection. A 
subject can initiate and support relations only with objects, not with other 
subjects. A subject can be a master as well as a slave. 

terminal server. A dedicated function system (processor, controller) 
providing attachment points for terminals in the local area via a responsive 
virtual circuit service spanning the shared interconnect. 

virtual circuit A communication path between a master and a slave. A virtual 
circuit is a bidirectional, sequential, timely, and error-free logical stream of 
data. On Ethernet, a virtual circuit service is a value added service since the 
Ethernet data link provides a datagram service. 
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B. Installation 



Before Installation 



Before you install LAT Host Services, you must have the following informa- 
tion: 

• The Factory Ethernet Address of your ES V Workstation. Enter the 
following command to get this address: 

/usr/etc/factaddr 

Factory Ethernet Address - - . - 

• The LAT Host Services Software Key Number ( 1 8 digits). Call Ki 
Research to at 1-800-544-8352 to obtain this number. You will be 
asked for the System Type (ES V Workstation) and the Factory 
Ethernet Address. 

Software Key Numbe r 



General Notes 

• You must be logged on the system as root. 

Loading the LAT Host Services Software 

Insert the LAT Host Services tape into the tape drive and enter the following 
command: 

/usr/pkg/bin/inst 

Following is an example which shows the loading of the LAT Host Ser- 
vices software. 

MIPS software package installation 

Install package relative to where [/]? <RETURN> 
Please mount the (first, if multiple tapes) distribution 
tape, then press return. . ,<RETURN> 

Rewinding the tape... Verifying tape id. . . ok 

Extracting packaging information tree... eslatl.O 

========== selecting subpackages ========== 

Install subpackage eslat (y n) [n] ? y 
Selected subpackages : 

eslat 
Is this what you want (y n) [y] ? <RETURN> 

========== setting system clock/calendar ========== 
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The current value of the clock is: Tue Feb 27 15:52:54 MST | 

1990 V 

Is the clock correct (y n) [y] ? <RETUFN> 
========== verifying single-user mode ========== 

This system is not presently in a single-user run level. 
Installation of a package can fail if performed at this 
run level. We recommend that the system be brought to a 
single user run level (using "init S") prior to 
performing the installation. 

Are you absolutely sure you wish to continue (y n) [n] ? y 

========== preserving local files ========== 

No preserve list or findmods list for eslat- preserve not 
executed. 

========== verifying disk space ========== 

The system will now be checked to verify that there is 
enough disk space with the current configuration to 
successfully install the package (and any selected 
optional subpackages) . For large packages (especially 
operating system packages) , this can be time 
consuming. . . 



There is enough space. 

========== stripping old links ========== 

Stripping links for subpackage eslat... 

======= extracting files from subpackage archives ======= 

Rewinding the tape . . . 
Verifying tape id. . . ok 
Forward spacing the tape... 

Loading subpackage: eslat... 
Forward spacing the tape . . . 
Rewinding the tape . . . 

========== running comply ========== 

running first comply pass . . . 

running second comply pass . . . 

There were no comply messages from the second pass. 

========== cleaning up old versions ========== 

An attempt will now be made to clean up any files left over 
from previous versions of the software which has just 
been installed. 

Searching for old versions to remove... 

========== restoring preserved user files ========== 
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No preserve list or findmods list for eslat- no files 
restored. 



cleaning up ===== 



Remove install tools (y n) [y] ? <RETURN> 
========== installation complete ======== 



Installing the Software Key 

Using any editor, create the file /etc/ki _pwd. Enter the Software Key Number 
on one line of this file, with no spaces before, or between, any of the 18 digits. 

If you have previously installed the ES/Dnet software, this file will al- 
ready exist. In this case, enter the ES/Dnet key after the existing key. 

Installing the LAT Host Services Software 

Run the installation script, which is located in the following file: 
/usr/etc/eslat/bin/install.lat. 

Following is an example which shows the installation of the LAT Host 
Services software. 

Ki LAT Installation procedure 

In -s /usr/etc/eslat/bin/lat /usr/etc/lat 
In -s /usr/etc/eslat/bin/latcp /usr/etc/latcp 
In -s /usr/etc/eslat/bin/uninstall.lat /usr/etc/ 
uninstall.lat 

If you want to know about options that can be used when starting LAT 
Host services, you can use the -help option (i.e., lat -help). 

Would you like to see this help display now? [Y/N] 
n 

Installation complete 

To start LAT Host Services, enter the following command: 

/etc/init.d/lat start 
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